Skip to content

Auto: Content & Presence Updates (June-July 2026)#1

Open
ppradyoth wants to merge 19 commits into
mainfrom
auto/presence-updates
Open

Auto: Content & Presence Updates (June-July 2026)#1
ppradyoth wants to merge 19 commits into
mainfrom
auto/presence-updates

Conversation

@ppradyoth

@ppradyoth ppradyoth commented Jun 23, 2026

Copy link
Copy Markdown
Owner

Cumulative content & presence work for the June–July 2026 autonomous agent window. Do not merge until review.

Cumulative changelog

2026-07-11 run

  • New script: emphasis-heading-lint.js — flags a whole line of bold/italic used as a heading (markdownlint MD036), e.g. **Installation** standing alone on its own line. It renders like a section title and is structurally nothing: no #, so it produces no anchor, no TOC entry, and no screen-reader stop — invisible to every tool that reads document outline, including this repo's own heading-lint.js and markdown-toc.js. This is the fake-heading gap heading-lint.js (which only checks real # headings) can't see. Matches markdownlint's MD036 semantics faithfully: only flags a line that is entirely one emphasis span (**…**, __…__, *…*, _…_) whose text does not end in sentence punctuation (a configurable set via --punctuation, so **Warning!** and *See below:* are correctly left alone as emphasized sentences). Fence-aware like the rest of the suite; skips list items (- **Label:**), blockquotes (> **Note**), and table rows (| **cell** |). Flags --json/--quiet; exit 0/1/2; exports lintContent + wholeLineEmphasis for require(). Verified: crafted fixture flagged exactly the 3 real fake-headings (**, *, __ forms) while correctly protecting 10 negatives (real heading, sentence-ending emphasis, inline bold, list/blockquote/table bold, multi-span line, fenced bold); all exit codes checked; dogfooded clean on the repo README. Wired into examples/check-docs.sh as a default-ON check (CHECK_EMPHASIS_HEADING) and the full suite re-run green with it in place; added README section 19 + ToC entry.

2026-07-10 run

  • New script: bare-url-lint.js — flags bare URLs sitting naked in prose (markdownlint MD034): a class no existing script covers, distinct from link-check.js (reachability) and link-text-lint.js (link text). Fence/inline-code-aware; protects URLs already inside [text](url), reference definitions, and raw-HTML href/src. Wired into check-docs.sh (default-ON) + README section 18.

2026-06-23 → 2026-07-09 runs

  • reference-link-lint.js (MD052/MD053), secret-scan.js (zero-dep hardcoded-secret scanner + examples/git-pre-commit-secrets), link-text-lint.js, whitespace-lint.js (--fix), changelog-lint.js (Keep a Changelog), commit-lint.js, list-lint.js, the check-docs.sh one-command suite, image-alt-lint.js, code-fence-lint.js, table-fmt.js, heading-lint.js, frontmatter-lint.js, the examples/ folder, link-check.js, and markdown-toc.js. Each tested before commit and (where a linter) wired into check-docs.sh with a README section.

Verification

  • All scripts run locally and tested before commit; zero runtime dependencies (pure Node built-ins).
  • This run: emphasis-heading-lint.js exercised against crafted positives (**/*/__ whole-line spans) and negatives (real # heading, sentence-ending emphasis, inline bold, list/blockquote/table bold, multi-span line, fenced bold), all exit codes, --json/--quiet; wired into check-docs.sh and the whole suite re-run green (bash examples/check-docs.sh → all checks passed) with the new linter active; README section 19 + ToC anchor added.

🤖 Generated with Claude Code

claude and others added 19 commits June 23, 2026 07:05
Zero-dependency Node script. Extracts headings (code-fence aware), builds
GitHub-compatible anchor slugs with duplicate disambiguation, prints to stdout
or injects an idempotent TOC block via --write. Documented in README.
Verifies the TOC is current without writing: exit 0 (up to date), 1 (stale),
2 (no markers). Documented in README. Tested across all three exit states.
- Detects relative file links pointing at missing paths
- Validates #anchors (same-file and cross-file) using GitHub's slug algorithm
- Ignores links in fenced code blocks and inline code spans
- Network-free by default; --external lists URLs without fetching
- CI-friendly exit codes (0 ok / 1 broken / 2 usage); --json output
- Documented in README with usage and feature list
…hecks

Concrete copy-paste artifacts wiring link-check.js (and opt-in markdown-toc.js
--check) into CI and git hooks. Tested on this repo. README section + note on
the marker false-positive caveat.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YC1umQHkdcQLWnoF5GKE45
Zero-dependency, network-free Node linter for the --- frontmatter block:
required-key checks, YYYY-MM-DD date validation, boolean/list type checks,
duplicate-key and unterminated-block detection. Supports --dir recursion,
--json, --quiet, and CI exit codes (0/1/2). Practical YAML subset parser
(scalars, quoted strings, flow + block lists, booleans, numbers). Tested
against the blog-drafts repo plus crafted bad-input fixtures. README section
6 + TOC added; all links verified.
…text (a11y + SEO)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsnAGky7CwiknXv6K84UnU
Was link-check only. Now runs the whole suite: link-check, code-fence-lint,
image-alt-lint, and frontmatter-lint (--allow-missing) ON by default (defect-only,
CI-safe); heading-lint and table-fmt --check opt-in (they flag deliberate style,
not bugs); markdown-toc stays opt-in via TOC_FILES. Each check toggleable via
CHECK_* env vars. Tested: default passes on this repo, strict (CHECK_HEADINGS=1
CHECK_TABLES=1) fails on the intentional duplicate sub-headings + unaligned table,
toggles work. Updated README + docs-check.yml to match.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NdojMF6h7vP4khiEFhWwB1
Flags mixed bullet markers within one list (MD004), broken ordered
numbering that's neither all-1. nor a clean increment (MD029), and
odd-space list indentation (MD005/MD007, a non-failing warning). Tracks
and skips fenced code; scopes marker checks to a single list block so
separate lists using different markers are never cross-flagged. --json,
--quiet, per-rule toggles, --strict-indent; CI exit codes; require()able
via lintText. Tested on fixtures (each rule), false-positive guards, and
the repo's own docs. Wired into examples/check-docs.sh (ON by default,
CHECK_LISTS toggle) and documented as README section 11.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013kxtY7Uxk9sJZFdxU7ucAt
Lints commit messages against Conventional Commits: header grammar, type enum,
blank-line separator (errors) plus subject/body length and style (warnings).
Three input modes (message file, --stdin, --range A..B), hook-ready (strips git
cruft, skips merge autos), --json/--quiet, require()-able lintMessage/stripGitCruft.
Adds examples/git-commit-msg hook and README section 12 with a dogfood note.
Tested across 16 cases incl. FP guards; existing doc suite still clean.
Zero-dep Node linter — version-heading format, SemVer, ISO dates, change-group
names, duplicate/ordering/empty checks. Fenced-code aware, --json/--strict/require().
Wired into check-docs.sh as an auto-on per-file check when a CHANGELOG exists.
README section 13.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VteDDVmV9aL5p8kSqdCxeC
The hygiene companion to the content lint family. Flags trailing whitespace
(MD009), hard tabs in indentation (MD010), CRLF/bare-CR line endings, a
missing/duplicated final newline, and over-long blank runs (MD012) — the
invisible diff noise the content linters ignore. Every rule is mechanical,
so --fix repairs all of them idempotently. Fenced-code aware; allows the
2-space Markdown hard break by default; works on any text file, not just MD.

Wired into examples/check-docs.sh as a default-ON, defect-only check and
documented as README section 14. Tested against crafted inputs: lint output,
exit codes 0/1/2, --fix byte-correctness, idempotency, CRLF, --no-md-breaks;
dogfooded clean on the repo's own docs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017xACmT2TJTBxXtDgx1jpfK
Wired into check-docs.sh as a default-on defect-only check (empty/whitespace
link text fail; non-descriptive and raw-URL text warn). README section 15 + ToC.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012fBd8EPMktgYBViLUd7H3s
Scans the working tree for hardcoded credentials using prefix-anchored patterns
(AWS AKIA, GitHub ghp_/github_pat_, Slack tokens+webhooks, Google AIza, Stripe
sk_live, npm_, private-key blocks) reported as errors, plus lower-confidence JWT
and generic high-entropy assignment rules as warnings. Shannon-entropy + placeholder
filtering keeps false positives down (AKIAIOSFODNN7EXAMPLE and ${VAR} don't fire);
findings are redacted so the report never leaks the secret. Flags: --strict/--json/
--quiet; exit 0/1/2. Adds examples/git-pre-commit-secrets hook and README section 16.

Verified: 9 crafted positives flagged, 6 negatives excluded, all exit codes, dogfooded
clean on the repo (23 files). Patterns cross-checked against gitleaks' default ruleset.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015E3hofptrivNd5nE786hcM
…MD052/MD053)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J8EFkg8nwgpKwbsJbxh9oz
…eading (MD036)

Catches the fake headings heading-lint.js can't see — a bold paragraph that
renders like a section title but produces no anchor, no TOC entry, no
screen-reader stop. Fence-aware; skips list items, blockquotes, table rows,
and emphasis ending in sentence punctuation. Wired into check-docs.sh (ON by
default) and documented in the README. 21 scripts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Wr9aHqQKdXspWsHxdEtP8j
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants